home *** CD-ROM | disk | FTP | other *** search
/ Network CD 2 / Network CD - Volume 2.iso / programs / internet / tcp / dial / dialer_1b.lha / dialer.readme < prev    next >
Encoding:
Text File  |  1994-07-16  |  6.2 KB  |  190 lines
  1.                             dialer.device 1.6
  2.  
  3.                            © 1994, Iain Hibbert
  4.  
  5.  
  6.     dialer.device is an autodialer/login program for all types of network
  7.   software that use the serial port, but don't know how to deal with modems
  8.   or login prompts.  It also enables you to have your modem hangup on DTR
  9.   drop
  10.  
  11.     dialer.device will work with *any* software that usually accesses a
  12.   serial port, such as any [C]SLIP or PPP devices for AmiTCP, any version
  13.   of AmigaNOS, any terminal program, and even the 'version' command.
  14.  
  15. 1. Installation
  16. ---------------
  17.  
  18.      This archive should contain three files:
  19.  
  20.             dialer.device       ; the autodialer
  21.             dialer0.config      ; an example configuration
  22.             dialer.readme       ; this file
  23.  
  24.      Copy dialer.device to your DEVS: directory, and create config files in
  25.    ENV: (and ENVARC:), then point your network software at dialer.device
  26.    instead of its usual serial.device.
  27.  
  28.      For automatic hangup, configure your modem to drop the line when DTR
  29.    is dropped (&D2 on most modems), then you just need to take the system
  30.    offline (in the case of AmiTCP) or exit the network software (AmigaNOS)
  31.    to hangup.
  32.  
  33. 2. Configuration
  34. ----------------
  35.  
  36.     Each unit of dialer.device can be configured differently, thus is is
  37.   possible to have several network connections using the same telephone
  38.   line. The configuration is held in a file called dialerX.config in your
  39.   ENV: directory, where X is the unit number (the unit number may be any
  40.   32-bit number). Only lines starting with valid keywords are interpreted,
  41.   this is a low-level device and no error messages are currently produced,
  42.   if you have any problems check the config file.
  43.  
  44.     When you have correctly configured dialer.device and your modem, you
  45.   can test it with the 'version' command, just type:
  46.  
  47.         version dialer.device unit 0
  48.  
  49.     at the shell prompt, and it should dial out and login to your network
  50.   provider, then hangup immediately. Success is indicated by printing the
  51.   version number of the serial device indicated by the DEVICE keyword -
  52.   this is because when dialer.device has finished its login, it steps out
  53.   of the way and leaves the network software to deal directly with the
  54.   serial device so there is no degradation in performance :-)
  55.  
  56.     The valid keywords are:
  57.  
  58.     DEVICE <string>
  59.  
  60.         The device to use. When dialer.device is successfully opened, it
  61.       returns a pointer to this device instead of itself.
  62.  
  63.         default: "serial.device"
  64.  
  65.     UNIT <number>
  66.  
  67.         The unit number of the serial device to use.
  68.  
  69.         default: 0
  70.  
  71.     BAUD <number>
  72.  
  73.         The Baud Rate to use
  74.  
  75.         default: <your prefs setting>
  76.  
  77.     INITSTRING <string>
  78.  
  79.         The first string that is sent to the modem, it should initialise
  80.       the modem, and cause it to return an OK within 5 seconds, or else the
  81.       device will return, unopened.
  82.  
  83.         default: "ATZ"
  84.  
  85.     DIALSTRING <string>
  86.  
  87.         The string we send before each phone number.
  88.  
  89.         default: "ATDT"
  90.  
  91.     PHONE <string>
  92.  
  93.         Multiple PHONE keywords are allowed. Each will be dialled in turn,
  94.       until we either get a "CONNECT", "ERROR", or "NO DIALTONE" message
  95.       from the modem, or else the window is closed.
  96.  
  97.       N.B.  If there are no numbers to dial, the dialer will assume that
  98.       there is no modem on the line and will skip directly to the CONVERSE
  99.       stage (no MODEMINIT, no Dialling)
  100.  
  101.     DIALTIMEOUT <number>
  102.  
  103.         When dialling, we will attempt to abort the dial if this many
  104.       seconds pass before we get a recognised result. The device will
  105.       continue dialling with the next number.
  106.  
  107.         default: 60
  108.  
  109.     CONVERSE <string> <string>
  110.  
  111.         Multiple CONVERSE keywords are allowed, none are required. The first
  112.       string is waited for, then the second string plus a CR is sent. To
  113.       send without waiting, leave the first string empty (ie "").
  114.  
  115.     TIMEOUT <number>
  116.  
  117.         The timeout to use when waiting for a CONVERSE string, if we
  118.       timeout, the device will fail to open.
  119.  
  120.         default: 30
  121.  
  122.     WINDOWSIZE <number> <number> <number> <number>
  123.  
  124.         Status window size when it opens
  125.  
  126.         default: 320 11 320 100
  127.  
  128.     ZOOMSIZE <number> <number> <number> <number>
  129.  
  130.         Alternative size, for when you press the Zoom gadget.
  131.  
  132.         default: 320 11 320 11
  133.  
  134.  
  135.     A <string> is delimited by spaces, or " quote characters.
  136.  
  137.     "This is one String"
  138.     This is four strings
  139.  
  140.     You can insert CR or LF into the string by using \r and \n
  141.  
  142. 3. Copyright
  143. ------------
  144.  
  145.      dialer.device is © 1994 Iain Hibbert and is  freely  distributable  as
  146.  long as all of its files are  included  in  their  original  form  without
  147.  additions, deletions, or modifications of any kind,  and  only  a  nominal
  148.  fee is charged for its distribution.
  149.  
  150.      This software is provided "AS IS" without warranty of any kind, either
  151.  expressed or implied. Reading Legal mush can turn your brain to guacamole.
  152.  By using dialer.device you accept either the whole risk or the quality and
  153.  performance of the program.
  154.  
  155. 4. The Author
  156. -------------
  157.  
  158.     Iain Hibbert         4 Avondale Road        plunky@skate.demon.co.uk
  159.                          Bath                   2:250/320.33@fidonet
  160.                          Avon BA1 3EG           39:138/14.33@amiganet
  161.                          England
  162.  
  163.      You should probably be able to reach me at one of the above addresses,
  164.  if you are using Comms software regularly.  Please contact me if  you have
  165.  any  problems  or  suggestions.  I  do  not  guarantee  to  implement  any
  166.  suggestions or fix any bugs, but it can't hurt to try.
  167.  
  168. 5. History
  169. ----------
  170.  
  171.     1.0     First Release
  172.  
  173.     1.4     1.0 would think it was successful if you aborted after
  174.             receiving the CONNECT message (ie during the login phase)
  175.  
  176.     1.6     removed the requirement to have PHONE keywords, at request
  177.  
  178. 6. Bugs
  179. -------
  180.  
  181.     Thats all, there is no more..
  182.  
  183.     Actually, there is one slight strangeness to do with the OpenDevice()
  184.   exec.library function call - *sometimes* if the device fails to open, it
  185.   tries again (once only) - this can manifest if you abort the dialling,
  186.   the dialer starts to try again (just close it again), or if the login
  187.   fails and the device tries again. I do not know why it does this.
  188.  
  189.     Any other problems, let me know..
  190.